home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / waisq.1 < prev    next >
Text File  |  1995-07-27  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4.      WWWWAAAAIIIISSSSQQQQ((((1111))))       TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTThhhhuuuu FFFFeeeebbbb 22220000 1111999999992222))))       WWWWAAAAIIIISSSSQQQQ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           waisq
  10.  
  11.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.           This is a shell level interface to WAIS questions that have
  13.           been built using xwais.  It allows a user to submit
  14.           questions to sources for queries, and to retrieve documents
  15.           from questions (and the appropriate source).  It can build
  16.           or modify a question, including the modification performed
  17.           during a search.
  18.  
  19.      UUUUSSSSAAAAGGGGEEEE
  20.           wwwwaaaaiiiissssqqqq
  21.             [-f question_file] /* defaults to stdin, stdout */
  22.             [-s sourcedir] /* or ~/wais-sources/ */
  23.             [-S sourcename]
  24.             [-c common_sourcedir] /* or it is ignored */
  25.             [-m max_Result_Docs] /* defaults to 40 */
  26.             [-v document_number]
  27.             [-g] /* to do a search */
  28.             [-h] /* this message */
  29.             [-t] /* test a source */
  30.             [-V] /* print version */
  31.             [word [word [...]]]
  32.           or
  33.  
  34.            wwwwaaaaiiiissssqqqq - [other options] /* for interactive mode */
  35.  
  36.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  37.           ----ffff _q_u_e_s_t_i_o_n__f_i_l_e_n_a_m_e
  38.                     the pathname for a question structure as stored in
  39.                     a file.  It uses standard UNIX conventions.  If no
  40.                     filename is provided, stdin is used.  If the
  41.                     filename is a dash ( - ), no question will be
  42.                     read, so you must specify a sourcename and the
  43.                     words to search.  This will create a question
  44.                     structure and write it to stdout.
  45.  
  46.  
  47.           ----ssss _s_o_u_r_c_e_d_i_r
  48.                     a directory where source structures are stored.
  49.                     It must end with a '/'.  If it is not specified,
  50.                     ~/wais-sources/ is used.  If none of those exist,
  51.                     the application will probably fail, unless the
  52.                     common_sourcedir exists.  Only files that end in
  53.                     .src in the directory are considered sources.
  54.  
  55.           ----SSSS _s_o_u_r_c_e_n_a_m_e
  56.                     the pathname of a source structure file.  It must
  57.                     exist in sourcedir or common_sourcedir, and end in
  58.                     .src
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/27/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      WWWWAAAAIIIISSSSQQQQ((((1111))))       TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTThhhhuuuu FFFFeeeebbbb 22220000 1111999999992222))))       WWWWAAAAIIIISSSSQQQQ((((1111))))
  71.  
  72.  
  73.  
  74.           ----cccc _c_o_m_m_o_n__s_o_u_r_c_e_d_i_r
  75.                     Similar to sourcedir, but usually common for a
  76.                     site. It need not exist.
  77.  
  78.           ----mmmm _m_a_x_D_o_c_s
  79.                     The limit on the number of results returned by a
  80.                     server.  Default value is 40.
  81.  
  82.           ----vvvv _d_o_c_u_m_e_n_t__n_u_m_b_e_r
  83.                     The number of the document to retrieve from a
  84.                     valid query.  This can be from a previously stored
  85.                     question, or the current question if the -g option
  86.                     is used.
  87.  
  88.           ----tttt        Test a source to see if it is servicing wais
  89.                     requests.  The first word will be taken as the
  90.                     name of a source.
  91.  
  92.           ----gggg        Submit the query.  You must specify the -g option
  93.                     in order to actually perform a query.  You need
  94.                     not specify it if you have already performed a
  95.                     query from which you wish to retrieve a document.
  96.  
  97.           ----VVVV        Print the version number and date of the program.
  98.  
  99.           wwwwoooorrrrdddd...   optional search keywords to replace any search
  100.                     keywords in the question.
  101.  
  102.           ----         If the first argument is a dash ( - ) then waisq
  103.                     operates in an interactive mode.  It then reads
  104.                     question structures from standard input, and
  105.                     returns results to standard output.  If the
  106.                     question has search-words or relevant documents,
  107.                     it performs the query, and returns the resulting
  108.                     question structure to standard output.  If there
  109.                     are only result documents, it retrieves them and
  110.                     prints them to standard output.  It continues to
  111.                     read it's input until an end of file is
  112.                     encountered, and then it exits.  All other command
  113.                     line switches will work, except -f.  This makes
  114.                     waisq useful as a tool for user interfaces to
  115.                     access the WAIS system.
  116.  
  117.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  118.           to create a new question and submit it for a query:
  119.                waisq -f - -S sourcename -g word1 word2 > my_question
  120.  
  121.           to submit an existing question for query:
  122.                waisq -f question_name -g
  123.  
  124.           To retrieve a response:
  125.                waisq -f question_name -v 1
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/27/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      WWWWAAAAIIIISSSSQQQQ((((1111))))       TTTThhhhiiiinnnnkkkkiiiinnnngggg MMMMaaaacccchhhhiiiinnnneeeessss ((((TTTThhhhuuuu FFFFeeeebbbb 22220000 1111999999992222))))       WWWWAAAAIIIISSSSQQQQ((((1111))))
  137.  
  138.  
  139.  
  140.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.           waisserver(1), waisindex(1), waissearch(1), xwais(1),
  142.           xwaisq(1)
  143.  
  144.           Wide Area Information Servers Concepts by Brewster Kahle.
  145.           brewster@think.com
  146.  
  147.  
  148.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  149.           The diagnostics produced by the application are meant to be
  150.           self-explanatory.
  151.  
  152.  
  153.      BBBBUUUUGGGGSSSS
  154.      AAAAUUUUTTTTHHHHOOOORRRR
  155.           Jonny Goldman <Jonathan@Think.COM>
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 7/27/95)
  196.  
  197.  
  198.  
  199.